                 Release notes for SNiFF+ Perforce Adapter
                 -----------------------------------------

Table of Contents
   * Versions
   * Features
   * Installation
   * Usage
   * Hints, limmitations and known problems
   * Changelist

Versions
   * Adapter:   3.2gcs of 22-Nov-1999
   * Perforce:  99.1
   * SNiFF+:    3.2 or later on both Unix and Windows

Features
   * Supports Checkout and Show History integrated into SNiFF
   * Submit and other Perforce specific commands via Custom Menu
   * Allows to switch between multiple Perforce Clients
   * Allows to change Perforce View definitions
   * Support of the SNiFF Shared Workspace Concept with either a single
     Perforce client or separate clients per SNiFF Working Environment

Installation
   * If the Adapter came with SNiFF+, just execute the Shellscript in
     $SNIFF_DIR/integrations/Perforce/install.sh     [on UNIX]
     %SNIFF_DIR%\integrations\Perforce\install.bat   [on Windows]

Upgrade to the new Adapter version
   * Download the Adapter from
   ftp://ftp.takefive.com/pub/SNiFF/integrations/Perforce/p4-3.2gcs.zip or
   ftp://ftp.takefive.com/pub/SNiFF/integrations/Perforce/p4-3.2gcs.tgz
   * Extract the archive contents into $SNIFF_DIR/integrations/Perforce
      - UNIX:    gunzip -c p4-3.2gcs.tgz | \
                 (cd $SNIFF_DIR/integrations/Perforce ; tar xfv -)
      - Windows: Winzip "extract to" %SNIFF_DIR%\integrations\Perforce
   * Execute $SNIFF_DIR/integrations/Perforce/install.sh, as above
   * If you were using existing Site Menu definitions, you need to merge
     them after installation from config/SiteMenus.P4-orig.sniff into
     config/SiteMenus.sniff

Documentation
   * Full Documentation is available from
   ftp://ftp.takefive.com/pub/SNiFF/integrations/Perforce/SniffWithPerforce.pdf
   ftp://ftp.takefive.com/pub/SNiFF/integrations/Perforce/SniffWithPerforce.ps.Z

Usage
   * Start SNiFF+ and open the Working Environments Tool.
   * Create a new RWE and set its Directory to the P4PORT you are using,
     for instance: "donald:1666"
   * Below, create a new PWE or SSWE and set its directory to where your 
     sources are located.
   * Set up a SNiFF Project and open it in the Project Editor. In the Project
     Attribute's "VCS" Node, select "Perforce" as the VCS Adapter to use.
   * In the Project Editor's Custom Menu, choose "Perforce --> Show/Change
     current P4Client" and make sure that you are working on the correct
     client name. 
     Note: By default, SNiFF will always use the environment variable P4CLIENT
     as the client; this can be overridden by setting SNIFF_P4CLIENT to
     some other client if you like. If you modify the client name, it will
     be persistently stored in the file ".p4client" in your working 
     environment root directory.
   * Choose "Perforce --> Create / Edit Client Specification". Make sure that 
     your Workspace is somewhere inside your current Perforce View.
   * For initial Checkin, select all files and choose "Perforce --> Add
     selected files", then choose "Perforce --> Submit".
   * You can now toggle the History Checkbox to show individual File's
     History. With "File --> Check Out" you can edit individual files.
     You can also show differences between individual versions, and use
     the Config Manager to get an overview of change lists.

Hints, limitations and known problems
   * Perforce Labels are not shown; the Config Manager only shows ChangeSets.

Changelist
   * Version 3.2gcs (22-Nov-1999):
      - new installation mechanism
      - Full Support for Diff/Merge Tool
      - Support for showing branches in History and Config Manager
      - Support for Exclusive Locking
      - Many Bugfixes
      - Allow to work with Shared Workspaces
      - Allow all actions for files which are not yet synced as well
      - New, more intuitive menu structure
   * Version 3.2rc1 (08-Oct-1999):
      - first public release
